﻿//////////////////////////////////////////////////////////////////////////////
//
//  Copyright © 1998-2024 Glodon Company Limited.  All rights reserved.
//
//  Use of this software is subject to the terms of the Glodon license
//  agreement provided at the time of installation or download, or which
//  otherwise accompanies this software in either electronic or hard copy form.  
//
//////////////////////////////////////////////////////////////////////////////

// Reviewed
#pragma once

#include "GcmpSnapInterface.h"
#include "IObject.h"

namespace gcmp {

    class ISnapCandidates;
    class ISnapContext;

    /// \brief 捕捉功能入口
    FINAL_INTERFACE class  GCMP_SNAP_INTERFACE_EXPORT Snapper : public IObject
    {
        DEFINE_CAST_DERIVED(gcmp::Snapper, gcmp::IObject);
    public:
        /// \brief 捕捉入口方法，根据捕捉输入信息，得到一组捕捉候选结果
        /// \param pContext 捕捉输入对象
        /// \return  捕捉结果候选集
        static OwnerPtr<ISnapCandidates> Snap(const ISnapContext* pContext);
    };
}// namespace gcmp

